Using Webhooks to Forward Events
You can use the events API as a webhook to forward events in your Resolve Actions instance. This is useful in the case you record events or alerts in an outside system but want to use the automation and orchestration capabilities of Actions to remediate the issue.
To use webhooks with Actions, configure your third-party application as follows:
- Add the bridge URL in the following format:
https://bridge.resolveactions.com/api/v1/gateway/PostMessage/<your_tenant_ID>
Example:bridge.resolveactions.com/api/v1/gateway/PostMessage/CF73494Z-8235-4743-B623-16454715DF91
- Add a basic authorization header.
The header must consist of the Events Client ID and the Events Secret Key (see Acquiring API Access Details), separated by a colon in base64 encoding.
Example:"Authorization": "Basic Qjg0RjFCMEItMTBER … … … …"
- If your connection details are as follows:
- Events Client ID:
B84F1B0B-10DF-4E4D-A748-ADEFEB47856C
- Events Secret Key:
^J*M*YT$!MVS8AVVLXXU!@72N5L4P22Q
- Events Client ID:
- Then the header before base64 encoding will look like (note the colon separating the ID and the Key):
B84F1B0B-10DF-4E4D-A748-ADEFEB47856C: ^J*M*YT$!MVS8AVVLXXU!@72N5L4P22Q
- The header after base64 encoding will look like:
Qjg0RjFCMEItMTBERi00RTRELUE3NDgtQURFRkVCNDc4NTZDOiBeSipNKllUJCFNVlM4QVZWTFhYVSFANzJONUw0UDIyUQ
- If your connection details are as follows:
- Create a payload in JSON format.
The payload will be automatically parsed into variables, as long as it consists of one or two levels. Any other format input will be passed as a regular event.
Example of a JSON payload:{
"System" : "mysystem",
"alert_type": "alert",
"alert_status": "critical",
"state": "down",
"information": "test alert",
"host": "my device",
"classification": "my category"
} - Expect a
200 OK
response.